Part Number Hot Search : 
HN7G09FE N5400 C8051F0 SS310A MSX40 8A2612W 0BA02 1620C
Product Description
Full Text Search
 

To Download HD6432357 Datasheet File

  If you can't view the Datasheet, Please click here to try to view without PDF Reader .  
 
 


  Datasheet File OCR Text:
  regarding the change of names mentioned in the document, such as hitachi electric and hitachi xx, to renesas technology corp. the semiconductor operations of mitsubishi electric and hitachi were transferred to renesas technology corporation on april 1st 2003. these operations include microcomputer, logic, analog and discrete devices, and memory chips other than drams (flash memory, srams etc.) accordingly, although hitachi, hitachi, ltd., hitachi semiconductors, and other hitachi brand names are mentioned in the document, these names have in fact all been changed to renesas technology corp. thank you for your understanding. except for our corporate trademark, logo and corporate statement, no changes whatsoever have been made to the contents of the document, and these changes do not constitute any alteration to the contents of the document itself. renesas technology home page: http://www.renesas.com renesas technology corp. customer support dept. april 1, 2003 to all our customers
cautions keep safety first in your circuit designs! 1. renesas technology corporation puts the maximum effort into making semiconductor products better and more reliable, but there is always the possibility that trouble may occur with them. trouble with semiconductors may lead to personal injury, fire or property damage. remember to give due consideration to safety when making your circuit designs, with appropriate measures such as (i) placement of substitutive, auxiliary circuits, (ii) use of nonflammable material or (iii) prevention against any malfunction or mishap. notes regarding these materials 1. these materials are intended as a reference to assist our customers in the selection of the renesas technology corporation product best suited to the customer's application; they do not convey any license under any intellectual property rights, or any other rights, belonging to renesas technology corporation or a third party. 2. renesas technology corporation assumes no responsibility for any damage, or infringement of any third-party's rights, originating in the use of any product data, diagrams, charts, programs, algorithms, or circuit application examples contained in these materials. 3. all information contained in these materials, including product data, diagrams, charts, programs and algorithms represents information on products at the time of publication of these materials, and are subject to change by renesas technology corporation without notice due to product improvements or other reasons. it is therefore recommended that customers contact renesas technology corporation or an authorized renesas technology corporation product distributor for the latest product information before purchasing a product listed herein. the information described here may contain technical inaccuracies or typographical errors. renesas technology corporation assumes no responsibility for any damage, liability, or other loss rising from these inaccuracies or errors. please also pay attention to information published by renesas technology corporation by various means, including the renesas technology corporation semiconductor home page (http://www.renesas.com). 4. when using any or all of the information contained in these materials, including product data, diagrams, charts, programs, and algorithms, please be sure to evaluate all information as a total system before making a final decision on the applicability of the information and products. renesas technology corporation assumes no responsibility for any damage, liability or other loss resulting from the information contained herein. 5. renesas technology corporation semiconductors are not designed or manufactured for use in a device or system that is used under circumstances in which human life is potentially at stake. please contact renesas technology corporation or an authorized renesas technology corporation product distributor when considering the use of a product contained herein for any specific purposes, such as apparatus or systems for transportation, vehicular, medical, aerospace, nuclear, or undersea repeater use. 6. the prior written approval of renesas technology corporation is n ecessary to reprint or reproduce in whole or in part these materials. 7. if these products or technologies are subject to the japanese export control restrictions, they must be exported under a license from the japanese government and cannot be imported into a country other than the approved destination. any diversion or reexport contrary to the export control laws and regulations of japan and/or the country of destination is prohibited. 8. please contact renesas technology corporation for further details on these materials or the products contained therein.
hitachi microcomputer development environment system high-performance embedded w o rkshop 2 (for windows ? 98/me, windows nt ? 4.0 , windows ? 2000 and windows ? xp) hew builder users manual ade-702-279a rev. 2.0 06/03/02 hitachi, ltd.
cautions 1. hitachi neither warrants nor grants licenses of any rights of hitachis or any third partys patent, copyright, trademark, or other intellectual property rights for information contained in this document. hitachi bears no responsibility for problems that may arise with third partys rights, including intellectual property rights, in connection with use of the information contained in this document. 2. products and product specifications may be subject to change without notice. confirm that you have received the latest product standards or specifications before final design, purchase or use. 3. hitachi makes every attempt to ensure that its products are of high quality and reliability. however, contact hitachis sales office before using the product in an application that demands especially high quality and reliability or where its failure or malfunction may directly threaten human life or cause risk of bodily injury, such as aerospace, aeronautics, nuclear power, combustion control, transportation, traffic, safety equipment or medical equipment for life support. 4. design your application so that the product is used within the ranges guaranteed by hitachi particularly for maximum rating, operating supply voltage range, heat radiation characteristics, installation conditions and other characteristics. hitachi bears no responsibility for failure or damage when used beyond the guaranteed ranges. even within the guaranteed ranges, consider normally foreseeable failure rates or failure modes in semiconductor devices and employ systemic measures such as fail-safes, so that the equipment incorporating hitachi product does not cause bodily injury, fire or other consequential damage due to operation of the hitachi product. 5. this product is not designed to be radiation resistant. 6. no one is permitted to reproduce or duplicate, in any form, the whole or part of this document without written approval from hitachi. 7. contact hitachis sales office for any questions regarding this document or hitachi semiconductor products.
trademarks microsoft, ms-dos, windows, windows nt are registered trademarks of microsoft corporation. visual sourcesafe is a trademark of microsoft corporation. ibm is a registered trademark of international business machines corporation. all brand or product names used in this manual are trademarks or registered trademarks of their respective companies or organizations. document information product code: s32hewm version: 2.1 copyright ? hitachi micro systems europe ltd. 2001. all rights reserved. copyright ? hitachi, ltd. 2001. all rights reserved.
rev. 2.0, 03/06/02, i about this manual this manual describes how to use the hitachi embedded workshop and the builder functionality. it covers all aspects of the build process from creating your project, adding and removing files and building the files. for information on the look and feel of the hitachi embedded workshop or customizing the hew environment please refer to the main hew user manual.
rev. 2.0, 03/06/02, ii document conventions this manual uses the following typographic conventions: table 1 typographic conventions convention meaning [menu->menu option] bold text with -> is used to indicate menu options (for example, [file->save as...] ). filename.c uppercase names are used to indicate filenames. enter this string used to indicate text that must be entered (excluding the quotes). key + key used to indicate required key presses. for example, ctrl+n means press the ctrl key and then, whilst holding the ctrl key down, press the n key. (the how to symbol) when this symbol is used, it is always located in the left hand margin. it indicates that the text to its immediate right is describing how to do something.
rev. 2.0, 03/06/02, iii contents cautions.......................................................................................................................................... iii 1. overview ................................................................................................. 1 1.1 workspaces, projects and files .......................................................................................... 1 1.1.1 the toolbars .......................................................................................................... 2 1.1.2 the workspace window ....................................................................................... 3 1.1.3 the output window .............................................................................................. 4 1.2 launching the hew ........................................................................................................... 5 1.3 creating a new workspace ................................................................................................ 6 1.4 opening a workspace ......................................................................................................... 7 1.5 saving a workspace............................................................................................................ 7 1.6 closing a workspace ......................................................................................................... .8 1.7 using old workspaces ....................................................................................................... 8 1.8 exiting the hew................................................................................................................. 8 2. build basics............................................................................................. 9 2.1 the build process ............................................................................................................... 9 2.2 project files......................................................................................................................... 10 2.2.1 adding files to a project ....................................................................................... 11 2.2.2 removing files from a project.............................................................................. 13 2.2.3 excluding a project file from build ..................................................................... 15 2.2.4 including a project file in build ........................................................................... 15 2.3 file extensions and file groups......................................................................................... 15 2.4 specifying how to build a file .......................................................................................... 22 2.5 build configurations........................................................................................................... 23 2.5.1 selecting a configuration ...................................................................................... 24 2.5.2 adding and deleting configurations .................................................................... 24 2.6 building a project................................................................................................................ 26 2.6.1 building a project .................................................................................................. 26 2.6.2 building individual files....................................................................................... 26 2.6.3 stopping a build .................................................................................................... 27 2.6.4 building multiple projects .................................................................................... 27 2.6.5 the output window .............................................................................................. 28 2.6.6 controlling the content of the output window ................................................... 28 2.7 file dependencies ............................................................................................................... 29 2.8 configuring the workspace window ................................................................................. 29 2.8.1 show dependencies under each file .................................................................... 29 2.8.2 show standard library includes ........................................................................... 30 2.8.3 show file paths ..................................................................................................... 31 2.9 setting the current project................................................................................................. .31 2.10 inserting a project into a workspace.................................................................................. 31 2.11 specifying dependencies between projects ....................................................................... 33 2.12 removing a project from a workspace.............................................................................. 34 2.13 relative projects paths in the workspace............................................................................ 35 3. advanced build features......................................................................... 36 3.1 the build process revisited ............................................................................................... 36 3.1.1 what is a build?..................................................................................................... 36 3.2 creating a custom build phase .......................................................................................... 38 3.3 ordering build phases ....................................................................................................... .42
rev. 2.0, 03/06/02, iv 3.3.1 build phase order...................................................................................................43 3.3.2 build file phase order ...........................................................................................45 3.4 setting custom build phase options ..................................................................................46 3.4.1 options tab ............................................................................................................46 3.4.2 output files tab .....................................................................................................47 3.4.3 dependent files tab...............................................................................................49 3.5 file mappings ......................................................................................................................51 3.6 controlling the build ...........................................................................................................53 3.7 logging build output..........................................................................................................54 3.8 changing toolchain version...............................................................................................55 3.9 using an external debugger................................................................................................56 3.10 generating a makefile .........................................................................................................58
rev. 2.0, 03/06/02, 1 1. overview this chapter describes the fundamental concepts of the hitachi embedded workshop. it is intended to give users who are new to windows? extra help, filling in the details that are required by later chapters. 1.1 workspaces, projects and files just as a word processor allows you to create and modify documents, the hitachi embedded workshop allows you to create and modify workspaces. a workspace can be thought of as a container of projects and, similarly, a project can be though of as a container of project files. thus, each workspace contains one or more projects and each project contains one or more files. figure 1.1 illustrates this graphically. project project project file file file workspace figure 1.1: workspaces, projects and files workspaces allow you to group related projects together. for example, you may have an application that needs to be built for different processors or you may be developing an application and library at the same time. projects can also be linked hierarchically within a workspace, which means that when one project is built all of its child projects are built first. however, workspaces on their own are not very useful, we need to add a project to a workspace and then add files to that project before we can actually do anything.
rev. 2.0, 03/06/02, 2 1.1.1 the toolbars the toolbars provide a shortcut to the options, which you will use the most often. there are eight default toolbars: bookmark, debug, debug run, editor, search, standard, templates and version control. toolbars can be created, modified and removed via the [tools->customize] menu option (see chapter 5, customizing the environment , in the hitachi embedded workshop 2.1 users manual, for further information). the builder toolbar is detailed below. figure 1.2: standard toolbar
rev. 2.0, 03/06/02, 3 1.1.2 the workspace window the workspace window when the hew is launched only has a single pane. this is the projects tab. if a workspace is opened then the workspace window displays two default tabs. the projects tab shows the current workspace, projects and files (figure 1.3). you can quickly open any project file or dependent file by double clicking on its corresponding icon. figure 1.3: workspace window projects tab the navigation tab provides jumps to various textual constructs within your projects files. what is actually displayed within the navigation tab depends upon what components are currently installed. figure 1.4 shows ansi c functions. see chapter 2, build basics , for more information on the workspace window. figure 1.4: workspace window navigation tab
rev. 2.0, 03/06/02, 4 1.1.3 the output window the output window by default has four tabs on display. the build tab shows the output from any build process (e.g. compiler, assembler and so on). if an error is encountered in a source file then the error will be displayed in the build tab along with the source file name and line number. to quickly locate a problem, double click on the error to jump to the source file and line. figure 1.5: output window
rev. 2.0, 03/06/02, 5 1.2 launching the hew to run the hew, open the start menu of windows?, select programs, select hitachi embedded workshop 2 and then select the shortcut of the hitachi embedded workshop. by default, the welcome! dialog shown in figure 1.6 will be displayed. figure 1.6: welcome! dialog to create a new workspace, select create a new project workspace, and click ok. to open one of recent project workspaces, select open a recent project workspace, select a workspace from the drop-down list, and click ok. to open a workspace by specifying a workspace file (.hws file), select browse to another project workspace, and click ok. to register a tool to or unregister a tool from the hew, click the administration button. click the cancel button to use the hew without opening a workspace.
rev. 2.0, 03/06/02, 6 1.3 creating a new workspace to create a new workspace: 1. select the create a new project workspace option from the welcome! dialog (figure 1.6) and press ok or select [file->new workspace...] . the new project workspace dialog will be displayed (figure 1.7). figure 1.7: new project workspace dialog 2. enter the name of the new workspace into the workspace name field. this can be up to 32 characters in length and contain letters, numbers and the underscore character. as you enter the workspace name the hew will add a subdirectory and project name for you automatically. this can be changed if desired. this allows the workspace and project name to be different. use the browse button to graphically select the directory in which you would like to create the workspace. alternatively, you can type the directory into the directory field manually. 3. select the cpu family and tool chain upon which you would like to base the workspace. note that this cannot be changed once the workspace has been created. 4. when a new workspace is created, hew will also create a project with the name specified in the project name field and place it inside the new workspace automatically. the project type list displays all of the available project types (e.g. application, library etc.). select the type of project that you want to create from this list. the project types displayed will be all valid types for the current cpu family and tool chain pair. 5. click ok to create the new workspace and project. note: it is not possible to create a workspace if one already exists in the same directory.
rev. 2.0, 03/06/02, 7 1.4 opening a workspace to open a workspace: 1. select browse to another project workspace option from the welcome! dialog (figure 1.6) and press ok or select [file->open workspace] . the open project workspace dialog will be invoked. 2. select the workspace file that you want to open (.hws files only). 3. click open to open the workspace. if the hew is set-up to display information when a workspace is opened then a workspace properties dialog will be invoked (figure 1.8). otherwise, the workspace will be opened. note that whether the workspace properties dialog is shown depends on the setting of either the show workspace information on workspace open check box on the workspace properties dialog or the display workspace information dialog on opening workspace check box on the workspace tab of the tools options dialog. this dialog is described in the specifying workspace options section in chapter 5, customizing the environment , in the hitachi embedded workshop 2.1 users manual. click ok to open the workspace. click cancel to stop opening the workspace. figure 1.8: workspace properties dialog the hitachi embedded workshop keeps track of the last five workspaces that you have opened and adds them to the file menu under the recent workspaces sub-menu. this gives you a shortcut to opening workspaces, which you have used recently. to open a recently used workspace: 1. select open a recent project workspace from the welcome! dialog, select the name of the workspace from the drop down list and then click ok. or: 2. select the [file->recent workspaces] menu option and from this sub-menu select the name of the workspace. note: the hitachi embedded workshop only permits one workspace to be open at a time. consequently, if you attempt to open a second workspace, the first will be closed before the new one is opened. 1.5 saving a workspace selecting [file-> save workspace] can save a hew workspace.
rev. 2.0, 03/06/02, 8 1.6 closing a workspace selecting [file-> close workspace] can close a hew workspace. if there are any outstanding changes to the workspace or any of its projects you will be requested whether or not you wish to save them. selecting [file-> save workspace] can save a hew workspace. 1.7 using old workspaces the hew can open any workspace that was created on a previous version of the hew. this should not cause any problems and any differences in the workspace file details should be upgraded on the open. note: the upgraded project cannot be used in the previous environment. a back-up version of the initial workspace or project file should have been saved if the project is used in the previous environment. 1.8 exiting the hew the hew can be exited by selecting [file->exit] , pressing alt+f4 or by selecting the close option from the system menu. (to open the system menu, click the icon at the upper-left corner of the hew title bar.) if a workspace is open then the same workspace closedown procedure is followed as described in the previous section.
rev. 2.0, 03/06/02, 9 2. build basics this chapter explains the general functions of the hew whilst the more advanced features can be found in chapter 3, advanced build features . 2.1 t he build process the typical build process is outlined in figure 2.1. this may not be the exact build process, which your installation of hew will use as it depends upon the tools that were provided with your installation of hew (e.g. you may not have a compiler for instance). in any case, the principles are the same - each step or phase of the build takes a set of project files and then builds them, if all succeeds then the next step or phase is executed. project object files c source files assembler source files library files load module build compiler assembler linker figure 2.1: typical build process in the example shown in figure 2.1 the compiler is the first phase, the assembler is the second phase and the linker is the third and final phase. during the compiler phase, the c source files from the project are compiled in turn, during the assembler phase, the assembler source files are assembled in turn. during the linker phase all library files and output files from the compiler and assembler phases are linked together to produce the load module. this module can then be downloaded and used by the debugger functionality in hew. the build process can be customized in several ways. for instance, you can add your own phase, disable a phase, delete phases and so forth. these advanced build issues are left to chapter 3, advanced build features . in this chapter, only the general principles and basic features will be detailed.
rev. 2.0, 03/06/02, 10 2.2 project files in order for the hew to be able to build your application, you must first tell it, which files should be in the project, and how each file should be built (figure 2.2). project c source files assembler source files library files debug: on optimize: off list file: yes debug: off optimize: off list file: yes debug: on silent: yes map file: yes add project files remove project files set compiler options set assembler options set linker options figure 2.2: editing a project
rev. 2.0, 03/06/02, 11 2.2.1 adding files to a project before you can build your application you must first inform the hitachi embedded workshop, which files it, is composed of. to add a files to a project: 1. select [project->add files...] , select [add files] from the workspace windows pop-up menu (see figure 2.3), or press ins when the workspace window is selected. figure 2.3: project pop-up menu 2. the add dialog will be displayed. 3. select the file(s), that you want to add and then click add.
rev. 2.0, 03/06/02, 12 there are a number of other ways to add new files to the project. these are described below: clicking right button on an open file in the editor window displays a pop-up menu option (figure 2.4). if the file is already in the project then the add file to project menu option is disabled. selecting the add file to project then adds the file to the current project. figure 2.4: editor window pop-up menu in the hew it is also possible to drag and drop files from windows explorer onto the workspace window. these files will be automatically added to the project and are displayed in the folder in which they were dragged to. note: if you add a file to a project when it is an unrecognized file type then it will still be added to the project. certain functions will be disabled with reference to this file. when this file is double clicked in the workspace window instead of opening the file in the editor the open operation is passed to windows operating system. the default open operation is then carried out as if the file was opened in windows explorer. to view the current defined extensions use the file extensions dialog (see the section on file extensions later in this chapter).
rev. 2.0, 03/06/02, 13 2.2.2 removing files from a project files can be individually removed from a project, selections of files can be removed or all files can be removed. to remove files from a project: 1. select [project->remove files...] , or select [remove files] from the projects tabs pop-up menu in the workspace window (see figure 2.5). the remove project files dialog will be displayed (figure 2.6). figure 2.5: projects tab pop-up menu figure 2.6: remove project files dialog
rev. 2.0, 03/06/02, 14 2. select the file or files which you want to remove from the project files list. 3. click the remove button to remove the selected files or click remove all to remove all project files. 4. click ok to remove the files from the project. to remove selected files from a project: 1. select the files, which you want to remove, in the projects tab of the workspace window. multiple files can be selected by holding down the shift or ctrl key. 2. press the del key. the files will be removed.
rev. 2.0, 03/06/02, 15 2.2.3 excluding a project file from build a file in a project can be individually excluded from build on a configuration by configuration basis. to exclude a file in a project from build: 1. push the right mouse button on a file, which you want to be excluded from build, in the projects tab of the workspace window. 2. select [exclude build file ] , where is the selected file, from the pop-up menu (figure 2.5). then a red cross will be put on the files icon, and the file will be excluded from build. 2.2.4 including a project file in build an excluded file can be included in the project again. to include a file which has been excluded from build: 1. push the right mouse button on a file, which has been excluded from build, on the projects tab of the workspace window. 2. select [include build file ] , where is the selected file, from the pop-up menu. then a red cross will be removed from the files icon, and the file will be included in build. 2.3 file extensions and file groups the hew can identify files by their extension. the system defines certain extensions depending upon the tools, which are being used. for example, if you are using a compiler then the .c extension will be in the c source file group and be used as input to the compiler phase (figure 2.1, typical build process). additionally, the hew allows you to define your own extensions. for example, if the project you are developing uses assembler source files the default extension may be .src. if you would like to use a different extension instead of .src (e.g. .asm) then you can define a new extension and request that the hew treats it in the same way as a .src file. file extensions and file groups can be viewed and modified via the file extensions dialog (figure 2.7). this is invoked by selecting [project->file extensions...] . this dialog displays all of the extensions and file groups, which are defined within the current workspace. figure 2.7: file extensions dialog
rev. 2.0, 03/06/02, 16 the file extensions list shown in figure 2.7 is divided into two columns. on the left are the file extensions themselves, whilst on the right are the file groups. many file extensions can belong to the same group. for example, assembler source files may have several extensions in a single project (e.g. .src, .asm, .mar etc) as shown in figure 2.8. .src .asm .mar .c .lib .lpf assembler source files c source files library files figure 2.8: file extensions and groups when creating a new extension you should consider whether the extension belongs to a group, which is already defined, or whether you need to create a new file group. if you are adding a completely new type of file then you will want to create a new file group. this process is described below.
rev. 2.0, 03/06/02, 17 to create a new file extension in a new file group: 1. select [project->file extensions...] from the menu bar. the file extensions dialog will be displayed (figure 2.7). 2. click the add button. the add file extension dialog will be displayed (figure 2.9). 3. enter the extension, which you want to define into the file extension field. it is not necessary to type the period ( . ) character. the drop list contains all extensions that are undefined in the current project. selecting one of these extensions will add the text to the file extension field automatically. 4. select the extension belongs to a new group option and enter a description, which defines this new file group. 5. at this stage it is possible to change the associated application. there are four available choices in the open with drop list. these are listed below: editor none other windows default if the editor is selected, the open file function in the workspace window causes the file to be opened in the hew editor. if none is selected then the open operation is disabled when the open file function is attempted. selecting other allows you to configure an another tool for the open file operation. see to associate an application with a file group for more details. if the windows default option is selected then the open file function in the workspace window passes the open file to the windows operating system. this then selects the default behavior for this file extension as defined in windows explorer. 6. click ok to add the extension to the file extensions list. figure 2.9: add file extension dialog (new group)
rev. 2.0, 03/06/02, 18 if you want to create a new extension because your project uses a different extension from those accepted by the hew. for example, a phase might by default use the extension .asm but the hew only recognizes .src. then you need to create a new extension and add it to an existing file group. this process is described below.
rev. 2.0, 03/06/02, 19 to create a new file extension in an existing file group: 1. select [project->file extensions...] from the menu bar. the file extensions dialog will be displayed (figure 2.7). 2. click the add button. the add file extension dialog will be displayed (figure 2.10). 3. enter the extension, which you want to define into the file extension field. it is not necessary to type the period ( . ) character. the drop list contains all extensions that are undefined in the current project. selecting one of these extensions will add the text to the file extension field automatically. 4. select the extension belongs to an existing group option and select which group you would like to add this new extension. 5. click ok to add the extension to the file extensions list. figure 2.10: add file extension dialog (existing group) in addition to opening a file with the editor, the file extensions dialog allows you to associate any application with any file group so that when you double click on a file in the projects tab of the workspace then the appropriate application is launched with the file. figure 2.11 shows the association between a word processor and the extension .doc.
rev. 2.0, 03/06/02, 20 figure 2.11: file groups and applications to associate an application with a file group: 1. select the file group to be associated from the file extensions dialog (figure 2.11). 2. click the open with button. the modify file extension dialog will be displayed (figure 2.12). figure 2.12: modify file extension dialog 3. select none to remove any association, select editor to open this type of file in the internal/external editor or select other if you want to open this type of file with a specific application. if you select other then you can select from any previously defined application from the drop-down list or specify a new application. 4. click add to define a new application. the add application dialog will be displayed (figure 2.13).
rev. 2.0, 03/06/02, 21 figure 2.13: add application dialog 5. enter the name of the tool into the name field. enter the full path to the tool in the command field (do not include any parameters). enter the parameters that are required to open a file in the parameters field. be sure to use the $(fullfile) placeholder to specify the location file (see appendix c, placeholders , in the hitachi embedded workshop 2.1 users manual, for more information on placeholders and their uses). enter the initial directory, in which you would like the application to run, into the initial directory field. click ok to create the application. 6. click modify to modify an application. the modify application dialog will be displayed. this dialog is the same as the add application dialog described above except that the name field is read only. modify the settings as desired and then click ok. 7. click ok to set the application for the selected file group.
rev. 2.0, 03/06/02, 22 2.4 specifying how to build a file once you have added the necessary files to the project the next step is to instruct the hew on how to build each file. to do this, you will need to select a menu option from the options menu. the contents of this menu depend upon which tools you are using. for example, if you are using a compiler, assembler and linker then there will be three menu options, each one referring to one of the tools. to set options for a build phase: 1. select the options menu and find the phase whose options you would like to modify. select this option. 2. a dialog will be invoked which allows you to specify the options. 3. after making your selections, click ok to set them. to obtain further information, use the context sensitive help button or select the area in which you need assistance and then press f1 .
rev. 2.0, 03/06/02, 23 2.5 b uild configurations the hew allows you to store all of your build options into a build configuration (figure 2.14). this means that you can freeze all of the options and give them a name. later on, you can select that configuration and all of the options for all of the build phases will be restored. these build configurations also allow the user to specify debugger settings for a build configuration. this means that each configuration can be targeted at a different end platform. (see chapter 7, debugging your hew project , in the hitachi embedded workshop 2.1 hew debugger users manual, for further information). figure 2.14 shows three build configurations; default, mydebug and myoptimized. in the first configuration, default, each of the phases (compile and assemble) are set to their standard settings. in the second configuration, mydebug, each of the files are being built with debug information switched on. in the third configuration, myoptimized, each of the files are being built with optimization on full and without any debug information. the developer of this project can select any of those configurations and build them without having to return to the options dialogs to set them again. c source files assembler source files c:\myproject\default "default" configuration c:\myproject\mydebug "mydebug" configuration c:\myproject\myoptimized "myoptimized" configuration debug: on optimize: off list file: yes debug: on optimize: off list file: no debug: off optimize: on list file: no debug: off optimize: on list file: no debug: off optimize: off list file: yes debug: on optimize: off list file: no figure 2.14: configurations and file options
rev. 2.0, 03/06/02, 24 2.5.1 selecting a configuration the current configuration can be set in two ways: either: 1. select it from the drop down list box (figure 2.15) in the toolbar. figure 2.15: toolbar selection or: 1. select [options->build configurations] . this will invoke the build configurations dialog (figure 2.16). figure 2.16: build configurations dialog 2. select the configuration that you want to use from the current configuration drop down list. 3. click ok to set the configuration. 2.5.2 adding and deleting configurations you can add a new configuration by copying settings from another configuration or delete a configuration. these three tasks are described below. to add a new configuration: 1. select [options->build configurations] to display the build configurations dialog (figure 2.16). 2. click the add button. the add configuration dialog will be invoked (figure 2.17).
rev. 2.0, 03/06/02, 25 figure 2.17: add configuration dialog 3. enter the new configuration name into the configuration name field. as you enter the new configuration name, the directory underneath changes to reflect the configuration directory that will be used. select one of existing configurations, from which you want to copy a configuration, out of the drop- down list of the based on configuration field. click ok on both dialogs to create the new configuration. to remove a configuration: 1. select [options->build configurations] to display the build configurations dialog (figure 2.16). 2. select the configuration that you want to remove and then click the remove button. 3. click ok to close the build configurations dialog.
rev. 2.0, 03/06/02, 26 2.6 building a project the outline of the build process is shown in figure 2.1. 2.6.1 building a project the build option only compiles or assembles those files that have changed since the last build. additionally, it will rebuild source files if they depend upon a file that has changed since the last build. for instance, if the file test.c #includes the file header.h and the latter has changed since the last build, the file test.c will be recompiled. to perform a build: select [build->build] or click the build toolbar button ( ) or press f7 or click the right mouse button on a project icon in the projects tab of the workspace window and select [build] from the pop-up menu. the build all option compiles and assembles all source files, irrespective of whether they have been modified or not, and links all of the new object files produced. to perform a build all: select [build->build all] , or click the build all toolbar button ( ), or click the right mouse button on a project icon in the projects tab of the workspace window and select [build all] from the pop-up menu. both the build and the build all will terminate if any of the project files produce errors. 2.6.2 building individual files the hitachi embedded workshop lets you build project files individually. to build an individual file: 1. select the file which you want to build from the project window. 2. select [build->build file] , click the build file toolbar button ( ) or press ctrl+f7 or click the right mouse button on a file icon in the projects tab of the workspace window and select [build ] from the pop-up menu.
rev. 2.0, 03/06/02, 27 2.6.3 stopping a build the hitachi embedded workshop allows you to halt the build process. to stop a build: 1. select [build->stop build] or click the stop build toolbar button ( ). the build will be stop after the current file has been built. 2. wait until the message build finished appears in the output window before continuing. to forcibly terminate a current tool 1. select [build->terminate current tool] . the hew will attempt to stop the tool immediately. note: do not assume that any output from the tool you terminated is valid. it is recommended that you delete any output files produced and ensure that the phase is executed again. 2.6.4 building multiple projects the hitachi embedded workshop lets you build multiple projects and configurations at once. to build multiple projects: 1. select [build->build multiple] . the figure displayed in figure 2.18. 2. the build multiple gives you the choice of which projects and configurations should be built. to select which projects and configurations need to be built select the check box next to the project C configuration combination you want to build. for example, in figure 2.18 if you wanted to build the entire hewtest2 project you would check the hewtest2-debug and the hewtest2-release selections and leave all other check boxes unchecked. 3. when you are happy with your chosen selection click the build button and the hew will then build the projects and configurations you have chosen. 4. if you want to build all the projects which you choose, you click the build all button. 5. results from the build are displayed in the build window in the same way as the normal build process. figure 2.18: build multiple dialog
rev. 2.0, 03/06/02, 28 2.6.5 the output window when a tool executes (i.e. compiler, assembler, linker etc.) its output is displayed in the output window. if any of the tools produce any errors or warnings then they are displayed along with the source file name and the line number at which the error is located. to quickly locate a specific bug, double click on a given error/warning to invoke the current editor. 2.6.6 controlling the content of the output window it is often useful to display low-level information (such as the command line options that are being applied to a file) during a build. the hew allows you to specify whether or not you want such options displayed in the output window during a build, build all or build file operation via the tools options dialog. to view or hide extra information during a build: 1. select [tools->options...] . the options dialog will be displayed. 2. select the build tab (figure 2.19). 3. set the three check boxes in the show group as follows. command line controls whether the command line is shown as each tool is executed. environment controls whether the environment is shown as each tool is executed. initial directory controls whether the current directory is shown as each tool is executed. figure 2.19: options dialog build tab
rev. 2.0, 03/06/02, 29 2.7 file dependencies a typical project will contain dependencies between files, for example, one c file may #include one or more header files. in complex projects, source files will include (or depend upon) others and this can quickly become difficult to manage. however, the hew provides a dependency scanning mechanism whereby all files in a project are checked for dependencies. once complete, the project window will display an up-to-date list with all the project file dependencies. to update a projects dependencies: select [build->update all dependencies] or click the right mouse button on a project icon in the projects tab of the workspace window and select [update all dependencies] from the pop-up menu. initially, the dependencies for all files are contained within the dependencies folder (figure 2.20.i). 2.8 configuring the workspace window if you click the right mouse button anywhere inside the projects tab of the workspace window, a pop-up menu will be invoked. select the configure view menu option to modify the way in which information is displayed. the following four sections detail the effect of each option on the configure view dialog. 2.8.1 show dependencies under each file if you select show dependencies under each file, the dependent files are shown under the including source file as a flat structure, i.e. the files themselves become folders (figure 2.20.ii). if this option is not selected then a separate folder contains all dependencies (figure 2.20.i). figure 2.20: dependencies under each file
rev. 2.0, 03/06/02, 30 2.8.2 show standard library includes by default, any dependent files found in standard include paths will not be shown (figure 2.21.i). for example, in c code, if you write an include statement such as #include then stdio.h will not be listed as a dependent file. to view such system include files, select the show standard library includes option (figure 2.21.ii). figure 2.21: standard library includes
rev. 2.0, 03/06/02, 31 2.8.3 show file paths if show file paths is selected, all of the files in the project window are shown with their full path, i.e. from a drive letter (figure 2.22). figure 2.22: file paths shown 2.9 setting the current project a workspace can contain more than one project but only one of the projects can be active at any time. this active project is the one which build actions and debug operations can be performed on. it is possible to change the builder or debugger options for the project. an active project is displayed in bold. to set a project as the current project: 1. select the project from the projects tab of the workspace window. 2. click the right mouse button to display the pop-up menu and select the [set as current project] option. or: 1. select the project, which you want to make active from the [project->set current project] sub-menu. 2.10 inserting a project into a workspace when a workspace is created, it contains only one project but, after it is created, you can insert new or existing projects into a workspace. to insert a new project into a workspace: 1. select [project->insert project] . the insert project dialog will be displayed (figure 2.23). 2. set the new project option. 3. click ok. the insert new project dialog will be invoked. 4. enter the name of the new workspace into the name field. this can be up to 32 characters in length and contain letters, numbers and the underscore character. as you enter the project name the hew will add a subdirectory for you automatically. this can be deleted if desired. 5. click the browse button to graphically select the directory in which you would like to create the project. alternatively, you can type the directory into the directory field manually. 6. the project type list displays all of the available project types (e.g. application, library etc.). select the type of project that you want to create from this list. 7. click ok to create the project and insert it into the workspace.
rev. 2.0, 03/06/02, 32 note: when a new project is being inserted, the cpu family and tool chain cannot be specified as these properties are already defined by the workspace (i.e. all projects within the same workspace target the same cpu family and toolchain). figure 2.23: [insert project] dialog
rev. 2.0, 03/06/02, 33 to insert an existing project into a workspace: 1. select [project->insert project] . the insert project dialog will be displayed. 2. set the existing project option. 3. enter the full path of the project database file (.hwp file) into the edit field or click browse to search for it graphically. 4. click ok to insert the existing project into the workspace. note: when an existing project is being inserted into a workspace, the cpu family and tool chain upon which that project is based must match those of the current workspace. if they do not then the project cannot be inserted into the workspace. 2.11 specifying dependencies between projects the projects within a workspace can be dependent upon one another so that when one project is built, all its dependent projects are built first. this is useful if another project uses one of the others in the workspace. for example, imagine that a workspace contains two projects. the first project is a library that is included by an application project. in this case the library must have been built and up to date before the second application can build correctly. to achieve this situation we can specify the library as a dependent (i.e. child) project of the application project. this would then allow the library to be built first if it is out-of-date. when a dependent project is built the hew attempts to match the configuration in the dependent project with that of the current project. this means that if the current configuration is debug then the hew will attempt to build the debug configuration in the dependent project. if this matched configuration does not exist then the hew will use the configuration that was last used in the dependent project. to make projects depend upon another: 1. select [project->dependent projects] . the dependent projects dialog will be displayed.(figure 2.24) 2. select the project to which you would like to add dependents to. when you do this, the dependent projects list will display all of the projects in the workspace (excluding the selected project). 3. the dependent projects list has a check box for each project listed. set the associated check boxes to make those projects depend upon the selected project. 4. click ok to confirm the new project dependencies. figure 2.24dependent projects dialog
rev. 2.0, 03/06/02, 34 2.12 removing a project from a workspace to remove a project from a workspace: 1. select the project from the projects tab of the workspace window and click the right mouse button to invoke a pop-up menu. 2. select the [remove project] option. or: 1. select the project from the projects tab of the workspace window. 2. press the del key. note: you cannot remove the current project from the workspace.
rev. 2.0, 03/06/02, 35 2.13 relative projects paths in the workspace in the hitachi embedded workshop when you add a project to the workspace you can choose to add the project to the workspace using a relative path. this allows you to position a project above the workspace directory and it will still be relocated correctly if you relocate the hew workspace. the project is always relative to the workspace so if the project is one directory above the workspace before it is moved the hew will try to find the project in the same relative location after the relocation procedure. this is especially useful if you are using a project shared between more than one workspace. in older versions of the hew this project would not have been relocated and would have still tried to access the original project path. the older version of the hew could only relocate the projects, which were in a subdirectory of the workspace directory. this is still the standard behavior for the hitachi embedded workshop. to change a projects relative path flag: 1. select the project in the workspace window. 2. right click and then select properties. 3. click the project relative file path checkbox to switch on or off the relative file path feature. (figure 2.25) 4. click ok. figure 2.25: properties dialog
rev. 2.0, 03/06/02, 36 3. advanced build features this chapter explains the more advanced build concepts. 3.1 t he build process revisited chapter 2, build basics began by describing the build process in terms of a compiler, an assembler and a linker (figure 2.1). this will be the case for most installations of the hitachi embedded workshop. however, if you want to begin changing the build process (e.g. adding and removing phases) then it is important to understand more about the way in which a build functions. 3.1.1 what is a build? building a project means applying a set of tools upon certain input files in order to produce the desired output. thus, we apply a compiler upon c/c++ source files in order to create object files, we apply an assembler upon assembler source files in order to create object files and so forth. at each step or phase of the build, we apply a different tool upon a different set of input files. figure 3.1 presents another view of the build process. begin end phase 1 phase 2 phase 3 phase x phase 1 output files phase 2 output files phase 1 input files phase 2 input files phase 3 output files phase x output files phase 3 input files phase x input files figure 3.1: build process
rev. 2.0, 03/06/02, 37 the hitachi embedded workshop provides the ability to change this build process via its build phases dialog, which can be, accessed via the [options->build phases] (figure 3.2). on the left-hand side are the phases that are defined in the current project (figure 3.2 shows a standard set of build phases). the remainder of this chapter details the various functions that the build phases dialog provides. figure 3.2: build phases dialog
rev. 2.0, 03/06/02, 38 3.2 creating a custom build phase if you want to execute another tool before, during or after a standard build process then this can be achieved by creating your own (i.e. custom) build phase. select [options->build phases] to invoke the build phases dialog (figure 3.2) and then click the add button. this will invoke the new build phase wizard dialog (figure 3.3a). the first step (as shown in figure 3.3a) asks whether you want to create an entirely new phase or whether you want to add a system phase. a system phase is a ready made phase which is already defined within the toolchain you are using (e.g. compiler, assembler, linker, librarian, etc.) or a utility phase (e.g. file copy, complexity analyzer etc.). the add an existing system phase button is inactive if no more system phases are available. select the create a new custom phase button to create your own build phase. figure 3.3a: new build phase dialog (step 1)
rev. 2.0, 03/06/02, 39 the second step (figure 3.3b) asks what type of phase you would like to create. there are two choices: multiple or single. when a multiple phase is executed, the command is applied to each file in the project of a certain file group. for example, if you set the input file group to be c source files then the command will be executed once for each c source file in the project. a single phase is executed once at most during a build. figure 3.3b: new build phase dialog (step 2) the input file group list contains the current file groups defined for the project. it is possible to define multiple input file groups by selecting the multiple groups entry in the input file group list. selecting this list entry displays the dialog in figure 3.3c. figure 3.3c: modify multiple input file groups once this choice has been made the input file group selection is displayed as multiple groups this dialog allows the user to choose multiple input file groups for the custom phase being added to the project. to select a file group check the box next to the file groups name. one or more file groups can be selected in this dialog.
rev. 2.0, 03/06/02, 40 the third step (figure 3.3d) requests the fundamental information about the new build phase. enter the name of the phase into the phase name field. enter the location of the program file into the command field (do not insert any command line options as these options are specified via the [options] menu of the hew menu bar). specify the default options for the phase (i.e. what options you would like new files to take when added to the project) into the default options field. if you have a preferred directory in which you would like this program to run from (i.e. where you want the current working directory to be set to before the tool is executed) then enter it into the initial directory field. figure 3.3d: new build phase dialog (step 3)
rev. 2.0, 03/06/02, 41 the fourth and final step (figure 3.3e) allows you to specify any environment variables, which the phase requires. figure 3.3e: new build phase dialog (step 4) to add a new environment variable click the add button (the dialog shown in figure 3.4 will be invoked). enter the variable name into the variable field and the variables value into the value field and then click ok to add the new variable to the list of the fourth step. to modify an environment variables select the variable in the list and then click the modify button. make the required changes to the variable and value fields and then click ok to add the modified variable to the list. to remove environment variables select the variable that you want to remove from the list and then click the remove button. figure 3.4: environment variable dialog if the tool you are adding can display its output as the tool is running then use the read output on fly option. this will display the tool output as each line of output happens. if this option is set to off then the hew will store all output, which is being displayed by the tool, and display it in the output window when the tool has finished its operation. this can be a problem when the tool is running an operation that might take many minutes, as it is difficult to see the progress of the current execution. note: using read output on fly can cause problems when using certain tools on certain operating systems. if you are having problems with tools locking up or freezing in hew then uncheck the read output on fly option. click the finish button to create the new phase. by default the new phase is added to the bottom of the build phase order list in the build order tab of the build phases dialog (figure ).
rev. 2.0, 03/06/02, 42 3.3 o rdering build phases in a standard build (shown in figure 3.5), you could add a phase at four different positions: before the compiler, before the assembler, before the linker or after the linker. you may place your own custom phases or move system phases to any position in the build order. it is important to remember that if the output of your custom phase can be input into another phase then the phase order must be correct if the build is to behave as intended. begin end compile assemble link 1 2 3 4 figure 3.5: typical build process the build phase dialog provides facilities for ordering build phases via the build phases dialog. it has two tabs, which are concerned with the ordering of phases: build order and build file order.
rev. 2.0, 03/06/02, 43 3.3.1 build phase order the build order tab (figure 3.6) displays the current order in which phases will be executed when the build ( ) or build all ( ) operation is selected. the check box to the left of each phase indicates whether or not it is currently enabled. by clicking this box, the phase can be toggled on or off. figure 3.6: build phases dialog build order tab in addition the following operations can be performed: to remove a phase: 1. select the phase that you would like to remove. 2. click the remove button. to view the properties of a system phase: 1. select the system phase that you would like to examine. 2. click the modify button. to move a phase: 1. select the phase that you would like to move. 2. click the move up or move down button. to import a phase: 1. click the import button. a dialog is displayed which allows the user to browse to an existing project to import a custom phase from. 2. choose the location of the project you wish to import a custom phase from. once selected a dialog is displayed which lists the custom phases in the imported project. 3. selecting a phase name and then clicking properties displays the custom phase details. this allows you to decide whether the phase does the functionality you require. 4. once you have decided which phase to import highlight it in the list and then click ok. the phase will then be added to the build phases dialog at the bottom of the build order.
rev. 2.0, 03/06/02, 44 to modify a custom phase: 1. select the custom phase that you would like to modify. 2. click the modify button. the modify phase dialog will be invoked with the command tab selected (figure 3.7). 3. change the contents of the fields as appropriate. 4. set the dont check for input file(s) existence before executing check box if you dont want the hew to abort the execution of the phase if any of the input files dont exist. figure 3.7: modify phase dialog command tab 5. select the environment tab (figure 3.8) to edit the environment settings for the phase. 6. use the add, modify and remove buttons to add, modify and remove environment variables. the operation is the same as discussed in the previous section. 7. click ok when all modifications have been made. figure 3.8: modify phase dialog environment tab
rev. 2.0, 03/06/02, 45 3.3.2 build file phase order if you were to select a c source file from the workspace window and then activate [build->build file] (or press ) you would expect the file to be compiled. likewise, if you were to select an assembly source file from the workspace window and then activate [build->build file] you would expect the file to be assembled. the connection between file group and which phase(s) to execute is managed by the build file order tab of the build phases dialog (figure 3.9). figure 3.9: build phases dialog build file order tab the list displays all of the current phases that will be executed when the build file operation is selected upon the file group shown in the file group list box. in figure 3.9 the c source file file group is selected and the compiler and myphase phases are associated with it. entries in the phase order list, of the build file order tab, are added automatically as new entries are added to the build order tab. for example, if you were to add a phase which takes c source files as input then this phase will be automatically added to the list of phases to execute when a build file operation is applied to a c source file. if you dont want a certain phase to execute when [build->build file] is selected then clear the check box to the left of the phase name in the phase order list.
rev. 2.0, 03/06/02, 46 3.4 setting custom build phase options once you have defined a custom phase, you will want to specify the command line options that should be used when it is executed. each defined phase has a menu option on the [options] menu. to specify options for that phase select it. the dialog that will be invoked depends upon whether the custom phase selected was a multiple or single phase (according to the selection of phase type in figure 3.3b). figure 3.10: custom options dialog the dialog in figure 3.10 is a custom phase options dialog. the implementation of which is slightly different depending on whether you are using a multiple or single shot phase. on the left-hand side is the project and file list. it is possible to select multiple projects and files in the same way as windows explorer to modify the options for more than one selection. on the right-hand side are the 3 options tabs. this is where you set the options that you want to apply to the selected file(s). you can also choose which configuration information is being viewed from the configuration list on the upper left of the dialog box. each configuration is listed along with a special entry named multiple configurations. if you select multiple configurations then a dialog is displayed which allows you to select more than one configuration. this method is used throughout hew for modifying multiple configurations at once. 3.4.1 options tab the options tab (figure 3.11) allows you to define the command line options that will be passed to the phase. the command field displays the command, which was entered when you defined the phase (figure 3.3d). enter into the options field the command line arguments that you would like to pass to the command. if you want to insert a placeholder, select the relevant placeholder from the placeholder drop-down list box and then click the insert button. for a detailed description of placeholders see appendix c, placeholders in the hitachi embedded workshop 2.1 users manual.
rev. 2.0, 03/06/02, 47 figure 3.11: custom options options tab 3.4.2 output files tab the output files tab (figure 3.12) is where you can specify the output file or files that will be produced by the phase. before each file is passed into this phase, the hew checks that the output files are of a less recent date than the input file. if so, the phase will be executed for that file (i.e. input files have been modified since the output file or files were last produced). if the files are up to date then the phase will not be executed. note: if no output files are specified, the phase will execute regardless.
rev. 2.0, 03/06/02, 48 figure 3.12: custom options output files tab to add an output file: 1. click add. the add output file dialog will be invoked (figure 3.13). 2. enter the file path or browse to it using the browse button. 3. click ok to add this output file to the list. figure 3.13: add output file dialog to modify an output file: 1. select the output file that you would like to modify. 2. click modify. the modify output file dialog, which is the same as figure 3.13 except the title, will be invoked. 3. modify the fields as required and then click the ok button to add the modified entry back to the list. to remove an output file: 1. select the output file that you would like to remove. 2. click the remove button.
rev. 2.0, 03/06/02, 49 3.4.3 dependent files tab the dependent files tab (figure 3.14) is where you can specify the dependent files that are needed by the phase. before each file is passed into this phase, the hew checks that the dependent files are of a more recent date than the input file. if so, the phase will be executed for that file (i.e. dependent files have been modified since the input file or files were last modified). if not, the phase is not executed for the files. figure 3.14: dependent files tab in custom options
rev. 2.0, 03/06/02, 50 to add a dependent file: 1. click add. the add dependent file dialog will be invoked (figure 3.15). 2. enter the file path or browse to it using the browse button. 3. click ok to add this output file to the list. figure 3.15: add dependent file dialog to modify a dependent file: 1. select the dependent file that you would like to modify. 2. click modify. the modify dependent file dialog, which is the same as figure 3.15 except the title, will be invoked. 3. modify the fields as required and then click the ok button to add the modified entry back to the list. to remove a dependent file: 1. select the dependent file that you would like to remove. 2. click the remove button.
rev. 2.0, 03/06/02, 51 3.5 file mappings by default, the files input to a phase are only taken from the project, i.e. all project files of the type specified in the select input file group drop-down list on the new build phase dialog (figure 3.3b). if you would like a phase to take files output from a previous phase (i.e. intermediate files) then you must define this in the file mappings tab of the build phases dialog (figure 3.16). figure 3.16: build phases dialog file mappings tab
rev. 2.0, 03/06/02, 52 a file mapping states that you would like the hew to pass output files of a certain type produced by one phase (referred to as the source phase) to another phase (referred to as the destination phase). such intermediate files are passed in addition to the project files. to add a file mapping: 1. click add. the define file mapping dialog will be invoked (figure 3.17). 2. select the file group, which you want to pass between the phases from the file group drop-down list box. 3. select the source phase (i.e. which phase generates the files) from the source phase drop-down list box. 4. select the destination phase (i.e. which phase takes these files) from the destination phase drop-down list box. 5. click ok to create the new mapping. figure 3.17: define file mapping dialog to modify a file mapping: 1. select the mapping to be modified. 2. click modify button. the define file mapping dialog will be invoked (figure 3.17). 3. modify the options as necessary. 4. click ok to commit the changes.
rev. 2.0, 03/06/02, 53 3.6 controlling the build by default, the hitachi embedded workshop will execute all of the phases in a build and only stop if a fatal error is encountered. you can change this behavior by setting the controls on the build tab of the options dialog (figure 3.18). figure 3.18: options dialog build tab select [tools->options] to invoke the dialog. if you want to stop the build when a certain number of errors are exceeded then set the stop build if the no. of errors exceed check box and then specify the error count limit in the edit field to the right. if you want to stop the build when a certain number of warnings are exceeded then set the stop build if the no. of warnings exceed check box and then specify the warning count limit in the edit field to the right. note: irrespective of what these controls are set to, the build will always halt if a fatal error is encountered. in addition to specifying error and warning count limits, the build tab also allows you to request that the command line, environment and initial directory of each execution should be displayed. check the appropriate check boxes as necessary.
rev. 2.0, 03/06/02, 54 3.7 logging build output if you would like to write the results of each build to file then invoke the customize dialog by selecting [tools->customize] and select the log tab (figure 3.19). set the generate log file check box and then enter the full path of the log file into the path field or browse to it graphically by clicking the browse button. figure 3.19: tools customize dialog log tab
rev. 2.0, 03/06/02, 55 3.8 changing toolchain version if two or more versions of the same toolchain are registered in the hew, you can choose a version of the toolchain on the change toolchain version dialog shown in figure . to invoke the dialog, select [tools- >change toolchain version] . choose one of the versions from the available versions drop-down list and click the ok button to enforce your choice. figure 3.20: change toolchain version dialog to show information of toolchain components select a tool from the toolchain build phases list on the change toolchain version dialog and click the information button. then a tool information dialog (figure 3.21) will show you the information of the tool. click the close button to close the dialog. figure 3.21: toolchain information dialog
rev. 2.0, 03/06/02, 56 3.9 using an external debugger the hitachi embedded workshop can launch an external debugger tool. if you want to use another debugger then you must add it to the tools menu (as described in chapter 5, customizing the environment , in the hitachi embedded workshop 2.1 users manual). the debugger tab of the customize dialog (figure 3.22) is where the hitachi debugging interface related information is configured. you may wish to use an older version of the debugger if certain targets are not currently supported in the new environment. invoke it by selecting [tools->customize] and then selecting the debugger tab. figure 3.22: customize dialog debugger tab when an external debugger is used, check use external debugger and then set the following items. firstly, the location of the hdi executable must be specified. this must be version 4.0 or greater otherwise the behavior is not guaranteed. the second item of data is the session file. this tells hdi which session to load when it is launched. finally, the location of the download module is required. this allows the hew to automatically switch to hdi when the download module changes after a build.
rev. 2.0, 03/06/02, 57 click the launch external debugger toolbar button to invoke hdi with the specified session file: after a build, if the download module has been updated, the hew will switch back to hdi to enable immediate debugging. whilst using hdi, double clicking in any source window will switch back to the hew with the source file open at the line which was double clicked.
rev. 2.0, 03/06/02, 58 3.10 generating a makefile the hew allows you to generate a makefile, which can be used to build parts of your workspace without hew. this is particularly useful of you want to send a project to a user who does not have the hew or if you want to version control an entire build, including the make components. to generate a makefile: 1. ensure that the project, which you want to generate a makefile for, is the current project. 2. ensure that the build configuration that you want to build the project with is the current configuration. 3. select [build>generate makefile] . 4. once this menu has been selected a dialog is displayed which asks the user what parts of the workspace need to be added to the make file. (see figure 3.23.) 5. select the radio button which is relevant for your make file and then click ok. figure 3.23: generate makefile dialog the hew will create a subdirectory make within the current workspace directory and then generate the makefile into it. it is named after the selection, with a .mak extension for example the current project and configuration(e.g. project_debug.mak). the executable hmake.exe, located in the hew installation directory, is provided for you to execute the makefiles generated by the hew. it is not intended to execute makefiles, which have been user modified. to execute a makefile: 1. open a command window and change to the make directory where the makefile was generated. 2. execute hmake. its command line is hmake.exe . note: the degree portability of a generated makefile is entirely dependent upon how portable the project itself is. for example, any compiler options, which include full paths to an output directory or include file directory, will mean that, when given to another user with a different installation, the build will probably fail. in general use placeholders wherever possible C using a full, specific path should be avoided when possible.


▲Up To Search▲   

 
Price & Availability of HD6432357

All Rights Reserved © IC-ON-LINE 2003 - 2022  

[Add Bookmark] [Contact Us] [Link exchange] [Privacy policy]
Mirror Sites :  [www.datasheet.hk]   [www.maxim4u.com]  [www.ic-on-line.cn] [www.ic-on-line.com] [www.ic-on-line.net] [www.alldatasheet.com.cn] [www.gdcy.com]  [www.gdcy.net]


 . . . . .
  We use cookies to deliver the best possible web experience and assist with our advertising efforts. By continuing to use this site, you consent to the use of cookies. For more information on cookies, please take a look at our Privacy Policy. X